home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / tag_bbs / tag201.zip / TAGFILE.DOC < prev    next >
Text File  |  1993-05-11  |  13KB  |  308 lines
  1. TAGFILE v2.00     by Tom Hansen, SysOp      Church Chatters (tm) BBS
  2.  
  3. ------------------------------------------------------------------------------
  4.                   TAGFILE a utility for BATCH uploading.
  5. ------------------------------------------------------------------------------
  6. Files included in this archive include:
  7.  
  8. TAGFILE.EXE : Main control program.
  9. DIRN.EXE    : File Tagging utility called by TAGFILE.EXE.  This may be run
  10.               independantly of TAGFILE.EXE
  11. TAGFILE.TXT : This document.
  12. ID.BAT      : Batch file for processing DIZ ( prepared descriptions ) files.
  13. TAGFILE.SLT : Salt file for compiling macro script for TELIX
  14. TAGFILE.SLC : Compiled TAGFILE.SLT script.
  15. DESC.SDI    : Desctripion of Program for BBS posting ( inserted by TAGFILE )
  16. FILE_ID.DIZ : Description of Program for BBS posting ( inserted by TAGFILE )
  17. UPDATE.DOC  : Updates  TAGFILE Documentation re: Bug fixes and enhancements.
  18.  
  19.  
  20.                    ------[ Setup:  How to do it! ]------
  21.  
  22. Run TAGFILE making sure TFCONFIG.EXE, DIRN EXE and all file compression
  23. utilities and protocol engines are in your path and or current directory.
  24.  
  25. 1.) To run this utility from your communications program:
  26.  
  27. BOYAN:
  28. I set  up  Boyan to use tagfile by executing the F9" key as a macro to call
  29. tagfile. To do this in Boyan, load BOYAN.COM.  Enter "ALT-C" to configure
  30. boyan.  When the configuration menu shows enter "M" for macros.  Pick the
  31. key you want to use from you menu options and then enter the macro as follows:
  32. \DC[TAGFILE]
  33.  
  34. TELIX:
  35. Use the TAGFILE.SLC or compile your own with the TAGFILE.SLT file using
  36. CS.EXE that comes with Telix.  Go into Telix and define any macro to
  37. execute @TAGFILE
  38.  
  39. TAGFILE.EXE and DIRN.EXE are in your path or your current subdirectory.
  40. And make sure the editor, DSZ and other protocols are in your path or
  41. current subdirectory.
  42.  
  43.     -----------------------[ Using Tagfile ]-------------------------------
  44.  
  45. The commands on the menu are self explanitory.  Your TAGFILE Menu looks
  46. as follows:
  47.  
  48.  
  49.  ┌───── Offline  Preparation ─────┐   ┌──── Online Command Hotkeys ─────┐
  50.  │                                │   │                                 │
  51.  │  [T] Tag files for Uploading   │   │       Send═════════════╗        │
  52.  │                                │   │       ║                ║        │
  53.  │  [A] Add file to tagged List   │   │       ║ ESC = Exit     ║        │
  54.  │                                │   │       ║                ║        │
  55.  │  [E] Edit tagged File List     │   │       ║ F2  = Shell    ║        │
  56.  │                                │   │       ║                ║        │
  57.  │  [K] Kill tagged File List     │   │       ║ F3  = Zmodem   ║        │
  58.  └────────────────────────────────┘   │       ║                ║        │
  59.  ┌──── Description  Utilities ────┐   │       ║ F4  = HS/Link  ║        │
  60.  │                                │   │       ║                ║        │
  61.  │  [S] DESC.SDI Descritpions     │   │       ║ F5  = BiModem  ║        │
  62.  │  [F] FILE_ID.DIZ Descriptions  │   │       ║                ║        │
  63.  │  [O] DOZ Descriptions          │   │       ║ F6  = Ymodem-g ║        │
  64.  │                                │   │       ║                ║        │
  65.  └────────────────────────────────┘   │       ║ F7  = Ymodem   ║        │
  66.  ┌───────── Configuration ────────┐   │       ║                ║        │
  67.  │                                │   │       ╚════════════════╝        │
  68.  │  [C] Configure Tagfile         │   │                                 │
  69.  │  [H] Configure HS/Link         │   │   [PGDN] = Download Commands    │
  70.  └────────────────────────────────┘   └─────────────────────────────────┘
  71.  
  72. T= Tag files.  You are then presented with a menu listing of files.
  73.    Our tagger now allows you to change subdirectories.  Simply highlight
  74.    the subdirectory or the ".." ( in lighter colors than file names ) and
  75.    hit carriage return to change.
  76.  
  77.  ░░░░░░░ Press Alt-T to tag all - Alt-U to remove Tags. ░░░░░░░░░
  78.  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  79.  ░┌─[■]──────────TagFile v1.50 - Directory Lister──────────[ ]─┐░
  80.  ░│  ..             HSLK10C6.ZIP                               │░
  81.  ░│  HS-BOYAN.ZIP   HSLK10C7.ZIP                               │░
  82.  ░│  HS-D.BAT       HSLK10C9.ZIP                               │░
  83.  ░│  HS-INST.ZIP    HSLK10D1.ZIP                               │░
  84.  ░│  HS-R173C.ARJ   HSLK10D2.ZIP                               │░
  85.  ░│  HS-R173C.ZOO   HSLK10D3.ZIP                               │░
  86.  ░│ √HS-R173C.ZIP   HSLK1124.ZIP                               │░
  87.  ░│  HS-U.BAT                                                  │░
  88.  ░│  HS-WC215.DOC                                              │░
  89.  ░│  HS-WC215.ZIP                                              │░
  90.  ░│  HSLK10B7.ZIP                                              │░
  91.  ░│  HSLK10C4.ZIP                                              │░
  92.  ░├────────────────────────────────────────────────────────────┤░
  93.  ░└░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░┘░
  94.  ░░░░░░░░░░░ Press SPACE to select or ESC to finish. ░░░░░░░░░░░░
  95.  
  96.  
  97.     Alt T will tag all the listed files with a check mark.  As
  98.     shown on the HS-R173C.ZIP file in the tagging utility, a space
  99.     bar will tag single files.  When done tagging then simply hit
  100.     your escape key and the tagged files will be added to the list
  101.     you specified.  This menu also has mouse functions built into
  102.     it for your convenience.  Stretch the window to your con-
  103.     venience and tag by clicking the mouse with the left button.
  104.  
  105.  1. A = Append file name to your list of files to send.  Does not
  106.     load the TAGGER.
  107.  
  108.  2. E = Edit your file list.  This function calls the editor you have named
  109.     on line 9 of your configuration file ( DGS.DEF ).  QEdit is recommended
  110.     for use here though any text editor ( NOT WORD PROCESSOR ) should work.
  111.  
  112.  3. K = Kill list of tagged files to start a new one.  This function
  113.     erases the list of tagged files so you can start a fresh new one
  114.     after you have uploaded to all your favorite BBSs.
  115.  
  116.  4. F = Add a file description to files in your tagged file list.
  117.     Creates preformated description files  written with the Tagfile internal
  118.     editor.  ID.BAT ( included with TAGFILE ) will add the DIZ file to your
  119.     tagged file once you have written the description.   TAGFILE passes the
  120.     extension to the batch file when it calls it.  This file must be found
  121.     in the current subdirectory or in your DOS path.
  122.  
  123.  5. F = Add a file description to files in your tagged file list.
  124.     Creates preformated description files  written with the Tagfile internal
  125.     editor.  ID.BAT ( included with TAGFILE ) will add the SDI file to your
  126.     tagged file once you have written the description.   TAGFILE passes the
  127.     extension to the batch file when it calls it.  This file must be found
  128.     in the current subdirectory or in your DOS path.
  129.  
  130.       ID.BAT:
  131.       %1 = the full name and path of the tagged file
  132.       %2 = the name of your description file DESC.SDI.
  133.       %3 = extension of the compressed file.
  134.      Sample ID.BAT:
  135.  
  136.       @ECHO OFF
  137.       GOTO %3 ELSE
  138.       GOTO EXIT
  139.       :ZIP
  140.       pkzip %1 c:\logo\chatters.bbs
  141.       ziplogo %1 c:\logo\logo.bbs
  142.       pkzip -k %1 %2
  143.       GOTO EXIT
  144.       :PAK
  145.       pak A %1 %2
  146.       GOTO EXIT
  147.       :ARC
  148.       pak A %1 %2
  149.       GOTO EXIT
  150.       :ARJ
  151.       arj a %1 %2
  152.       GOTO EXIT
  153.       :ZOO
  154.       zoo a %1 %2
  155.       GOTO EXIT
  156.       :EXIT
  157.  
  158.  6. O = Do RBATCH style DOZ descriptions.  Tagfile will create a text list
  159.     formatted to be accepted by RBATCH ( the RBBS-PC external Batch Upload
  160.     handler.
  161.  
  162.     The .DOZ format is as follows:
  163.  
  164.                 {FI RBATCH.ZIP
  165.                 Description of file goes here with a maximum
  166.                 line length of 45 characters and a maximum
  167.                 of 10 lines
  168.                 {FI TAG160.ZIP
  169.                 Description of file goes here with a maximum
  170.                 line length of 45 characters and a maximum
  171.                 of 10 lines
  172.  
  173.  
  174. Line 1 :  ALWAYS STARTS WITH A {FI and then the filename.  Tagfile
  175.           Will create this line for you. Notice there is no path. It
  176.           is not needed.
  177.  
  178. Line 2 thru 11 :  The description of the file to be posted with
  179.                   a maximum line length of 45 chars and a maximum
  180.                   of 10 lines.  These standards were set to comply
  181.                   with the FILE_ID.DIZ and DESC.SDI formats.
  182.  
  183. Tagfile will automaticly include the file description file in you tagged
  184. file list and will place it first.  If you are for any reason disconnected
  185. from the host while in the midst of a transfer you will be assured of having
  186. sent your descriptions first so all successful uploads will be automaticly
  187. posted by RBATCH if your host has this batch handler installed.
  188.  
  189.  
  190.  7. Hot/Keys for on-line functions.
  191.  
  192.     We assume your copy of DSZ is registered! and add the path for downloads
  193.     to your command string.  If it is not leave your DL target directory
  194.     blank when you configure TAGFILE
  195.  
  196.     F2 = Shell to Dos
  197.  
  198.     F3 = Send Tagged files using Zmodem
  199.  
  200.     F4 = Send tagged files using HS/Link.  This may be used to execute
  201.         a bidirectional transfer.  Tell the BBS you are calling that
  202.         you want to download a file using HS/Link.  When the system says
  203.         it is ready to send the file then shell to TAGFILE and execute the
  204.         "H" command and your bidirectional transfer will begin.
  205.     F5 = Send tagged files using BiModem.  This may be used to execute
  206.         a bidirectional transfer.  Tell the BBS you are calling that
  207.         you want to download a file using BiModem.  When the system says
  208.         it is ready to send the file then shell to TAGFILE and execute the
  209.         "B" command and your bidirectional transfer will begin.
  210.  
  211.     F6 = Send Tagged files using Ymodem-g
  212.  
  213.     F7 = Send Tagged files using Ymodem Batch
  214.  
  215.  
  216.     ESC = Exits Tagfile.
  217.  
  218. PGDN Clears menus and presents only the available keys while
  219. you are in DL mode.  Same keys are assigned to the various
  220. protocols with the exception of the ESC which escapes the Download
  221. menu.
  222.  
  223.  
  224. Once you have tagged some files for uploading, dial your favorite BBS
  225. and have a good time transferring files.  Be sure to upload quality files.
  226. This makes your sysop infinitely happy.
  227.  
  228. Tom Hansen, Sysop (DGS-Tango)
  229. CHURCH CHATTERS BBS   (402)593-8863 14.4k ZOOM v.32/v.32bis
  230.  
  231.  
  232.  
  233.                    DGS - Dedicated to Great Support!
  234.  
  235. I want to thank the following people for helping to test TAGFILE and
  236. especially Dan Shore for writing RBATCH which was the inspiration for
  237. writing this utility to simplify batch uploading to RBBS-PC systems.
  238. All new TAGFILE features may be tested on the following systems in
  239. addition to our own : Tom Hansen (DGS-Tango)  CHURCH CHATTERS BBS
  240. (402)593-8863 HST
  241.  
  242. Mike Siegel
  243. Friend and dedicated user of Tagfile.
  244.  
  245. Samual Smith (Author HS/Link)
  246. ToolShop BBS
  247.  
  248. Dan Shore (DGS-Wonder)
  249. THE SHORELINE BBS     (301) 946-2771  HST
  250.  
  251. Walter Ames (DGS-Viper)
  252. THE WORLD OF GREYHAWK (410) 461-9943  Dual
  253.                       (410) 465-3891  Dual
  254.  
  255. Gregg Snyder (DGS-Alpha)
  256. THE ELUSIVE DIAMOND   (703) 323-6423  HST
  257.                       (703) 323-1782  HST
  258.  
  259.  
  260.               ------------------------------------------
  261.               TAGFILE WARRANTY, REGISTRATION AND SUPPORT
  262.               ------------------------------------------
  263.  
  264. Warranty & Disclaimer:
  265.  
  266. THIS PRODUCT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
  267. INCLUDING ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR
  268. PURPOSE.  THE ENTIRE RISK AS TO THE RESULTS AND PERFORMANCE OF THE
  269. PROGRAM IS ASSUMED BY YOU.  FURTHERMORE, I THE AUTHOR DO NOT WARRANT,
  270. GUARANTEE, OR MAKE ANY REPRESENTATIONS REGARDING THE USE OF OR THE
  271. RESULTS OF THE USE OF THE PROGRAM, OR THAT THE PROGRAM WILL RUN WITHOUT
  272. ERROR, AND YOU RELY ON THE PROGRAM AND RESULTS SOLELY AT YOUR OWN RISK.
  273. I THE AUTHOR CANNOT ACCEPT RESPONSIBILITY FOR SYSTEM DAMAGE, LOSS OF
  274. PROFIT, OR ANY OTHER SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
  275. RESULTING FROM THE USE OR INABILITY TO USE THIS PRODUCT.
  276.  
  277. As always, with any new program, you should have a backup of your system.
  278.  
  279. You can always call my BBS and download the official version.
  280.  
  281.  
  282. Registration:
  283.  
  284. This program is being released under the "shareware" concept.  This means
  285. that you can try it out to see what it is like for a period of time.  If
  286. after a period of 60 days you continue to use it, then your registration
  287. is requested.
  288. Support:
  289.  
  290. If you encounter any problems with the program, or have suggestions
  291. on improvements, you may call my BBS 24 hrs a day, and leave a message
  292. or leave a message on the RIME Network in the RBBS conference. I will
  293. consider the enhancements and of course try to fix any problems
  294. encountered with the program.  My BBS name & number is:
  295.  
  296.                          Tom Hansen
  297.                     "CHURCH CHATTERS BBS"
  298.                        USR HST 14.4k
  299.                        402-593-8863
  300.                      Proud Member of the
  301.                 - DGS Systems Group (Tango) -
  302.  
  303.                    Proudly Running RBBS-PC
  304.              "The Best BBS Software in the World"
  305.  
  306.                  Member of the RIME Network
  307.                     Node ID = OUTRIDER
  308.